gtk-demo: Tweak descriptions of constraints demos

Make these a little longer, and include more details.

constraintlayout: Make sure guides get their constraints

When using GtkBuilder to create constraints and guides,
the layout manager is already rooted when the guides get
created, and we were forgetting to create the guides
constraints in this case. Fix it by adding a call to
gtk_constraint_guide_update().

This was showing up in the new builder-based constraints
demo as the guide not having the expected effect.

constraintlayout: Emit less change notification

This isn't strictly required for correctness, but
it makes the GtkBuilder codepath do the same that
the vfl codepath does: call gtk_layout_manager_layout_changed
only once, after all the constraints have been added.

gtk-demo: Tweak the new constraints demo

With these somewhat random ordering changes, things get
closer to working the same as the code example. Still,
the guide doesn't work right.

constraintlayout: Fix parsing from ui file

Guides were not properly looked up when creating
constraints in a ui file.

Add another constraints demo

This one attempts to use constraints in a ui file.
It doesn't work.

gtk-demo: Remove unnecessary code

I was distracted by this code that sets names
on widgets in the constraints demo - the names
aren't used and aren't needed, so remove them.

docs: Add details for gsk_renderer_new_for_surface

Mention the GSK_RENDERER variable here.

NEWS: Updates

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!2760

Merge branch 'wip/chergert/gdk-macos-gl-renderer' into 'master'

macos: implement GL rendering on with Cairo renderer

See merge request GNOME/gtk!2759

docs: Some restructuring

Give the GDK docs some more structure.

docs: Tweak GdkToplevel docs

docs: Tweak GdkPopup docs

docs: Tweak GdkSurface docs

Add more details, and refer to the GdkToplevel / GdkPopup
docs.

docs: Tweak frame clock docs

docs: Small additions for GdkCursor docs

docs: Cosmetics

Make the GdkRGBA heading less repetitive.

docs: Tweak GdkPaintable docs

Minor additions here and there.

docs: Add some detail to GdkTexture docs

Minor additions here and there.

gdk: Drop GdkPoint from the api

This typedef was not used in any public APIs, and is
only used in the MacOS backend. It is not worth preserving
as public API, move it to the only user.

docs: Include GDK_WINDOWING_MACOS

We no longer have a Quartz backend, it is called
MacOS now.

docs: Stop referring to the Quartz backend

Its MacOS now.

macos: implement GL context

This implements the basics for a GdkGLContext on macOS. Currently, rendering
only is fully working for the GskCairoRenderer case where we read back pixels
into a cairo surface for rendering. More work on synchronization is required for
the GL on GskGLRenderer case.

When we attempt to render a surface itself with GL, the context will ensure that
the new GdkMacosGLView is placed within the NSWindow. In other cases, we
use a dummy NSView and NSWindow for backing the NSOpenGLContext to
ensure that we can get accelerated drawing.

This gets GtkGLArea working when running with GSK_RENDERER=cairo.

macos: tweak gravity while resizing

This helps a situation where the window contents has not changed
in time for a drawing. Setting the texture gravity helps that side or
corner to be less jittery while moving.

Ideally, we can get to a point where we are synchronized and keeping
up with drawing fast enough to not need this. That may require some
work to drive frame clocks from drawRect: though.

macos: be tolerant of NULL GL context

Some code appears to unconditionally attempt to make the context current,
so this makes things tolerant to a NULL GdkGLContext and just return FALSE.

glsl: tweak pre-processor to support Apple GLSL compiler

The Apple GLSL compiler cannot deal with empty pre-processor blocks such as

  #if GSK_GLES
  #elif GSK_LEGACY

macos: remove unused GL layer

This isn't being used, and instead we'll go the route of a NSView for
the OpenGL implementation.

macos: move setNeedsDisplay helper to GdkMacosCairoView

This isn't needed in the base class, which will eventually get a GL subclass.

Merge branch 'wip/chergert/gdk-remove-texture_from_surface' into 'master'

gl: remove unused texture_from_surface API

See merge request GNOME/gtk!2756

gl: remove unused texture_from_surface API

This is not used anywhere and only exists within the X11 backend. It
can be removed now.

Cosmetics

Whitespace fix.

Merge branch 'matthiasc/for-master' into 'master'

textview: Update child allocations

See merge request GNOME/gtk!2757

textview: Update child allocations

This was accidentally lost when display line caching
was introduced.

Update POTFILES.skip

Merge branch 'wip/baedert/for-master' into 'master'

Wip/baedert/for master

Closes #3282

See merge request GNOME/gtk!2755

Merge branch 'dropdown-checkmark' into 'master'

Dropdown checkmark

Closes #3291

See merge request GNOME/gtk!2754

gtk-demo: Add checkmarks to all dropdown demos

This follows the mockups that these demos are
copied from. Unfortunately, it has to be implemented
for every item factory, so we repeat it here.

Fixes: #3291

dropdown: Add a checkmark to the selected item

Make the default factory add a checkmark to the
currently selected item (not the hovered item)
in the popup. This will unfortunately have to be
done in non-default factories too.

Related: #3291

dropdown: Make search entry shrink

We don't want the popup to be wider than the button
if we can help it. The search entry does not need
to be very wide.

Merge branch 'matthiasc/atspi-child' into 'master'

Emit ChildrenChanged signal on hierarchy updates

See merge request GNOME/gtk!2752

Merge branch 'matthiasc/a11y-buildable' into 'master'

Implement accessible attributes for ui files

See merge request GNOME/gtk!2751

Merge branch 'wip/otte/for-master' into 'master'

Wip/otte/for master

Closes #3295

See merge request GNOME/gtk!2748

cloudprint: Make compile without warnings

gtkmediafile: Use cubic volume function

Gstreamer suggests doing that.

https://gitlab.freedesktop.org/gstreamer/gst-plugins-bad/-/issues/1439

Fixes #3295

Merge branch 'wip/jimmac/gtk4-dropdown-papercuts' into 'master'

Adwaita: dropdown search box

See merge request GNOME/gtk!2747

Adwaita: dropdown search box

- have some whitespace around entry

Partial fix for https://gitlab.gnome.org/GNOME/gtk/-/issues/3291

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!2746

Merge branch 'popover-menu-custom-child' into 'master'

popovermenu: Allow custom items

Closes #3260

See merge request GNOME/gtk!2728

docs: Add GtkOverlay to the widget gallery

docs: Add box, grid and center box to the gallery

modelbutton: Explicitly set up LABELLED-By relation

GTK does this automatically based on mnemonics, but only
if the string actually contains a mnemonic. This makes
orca read out menuitems, as expected.

widget-factory: Add a scale to the gear menu

This tests the custom menuitem support, and lets you
control the transition duration for the main stack.

popovermenu: Allow adding custom items in ui files

Support <child type="ID"> to fill custom child slots
in both GtkPopoverMenus and GtkPopoverMenuBars that
are created in ui files.

popovermenu: Allow custom items

Add a way to add children at certain places in
the generated menu for both GtkPopoverMenu and
GtkPopoverMenuBar.

New apis:
gtk_popover_menu_add_child
gtk_popover_menu_remove_child
gtk_popover_menu_bar_add_child
gtk_popover_menu_bar_remove_child

Fixes: #3260

Merge branch 'master' into 'master'

Fix the build with cups < 2.2.12

Closes #2968

See merge request GNOME/gtk!2744

Fix the build with cups < 2.2.12

PPD_CUSTOM_UNKNOWN was introduced in cups 2.3.
and has been backported to 2.2.12.
Only handle it when we build against a new enough cups.

Fixes: #2968

Treat tristate as an enum when parsing

This makes it so that you have to explicitly specify
"true" and "false" for the checked state, but it
matches how this enumeration is meant to be used.

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!2741

docs: Add GtkDrawingArea to the gallery

docs: Add GtkShortcutsWindow to the widget gallery

docs: Add GtkPopoverMenu to the widget gallery

docs: Add GtkPopover to the widget gallery

docs: Add GtkPopoverMenuBar to the gallery

docs: Add GtkExpander to the gallery

docs: Add GtkEmojiChooser to the gallery

To make this possible enable the doc shooter
to take screenshots of popovers.

docs: Redo the GtkColorChooserDialog gallery image

Show the new palette.

docs: Improve the GtkStackSidebar gallery image

docs: Tweak gallery layout

Now that the volume button image is small, move it
to a better place in its section. Improves the layout.

docs: Fix the GtkVolumeButton gallery image

Give up on showing the popup, we don't do that
for other buttons either.

docs: Add GtkCalendar to the gallery

It has been missing far too long.

docs: Improve the GtkMediaControls gallery image

docs: Improve the GtkVideo gallery image

docs: Tweak gallery layout

Improve the breaks in the container section.

docs: Shrink the editable label gallery image

Makes it fit better with the other entries.

docs: Some reordering in the gallery

Align things better.

docs: Work around GtkPicture growing

Make the GtkPicture gallery image stay within its
limits, by overpowering its request mode.

docs: Tweak gallery ordering

Move GtkSpinButton to the entries, where it
belongs, despite its name.

docs: Fix links from the gallery

It turns out gtk-doc can't even parse its own custom
links if you don't arrange for the <link> element to
on a single line, since it is just a glorified sed
script :(

docs: Add GtkWindowControls to the gallery

a11y: Add more tests

Test some of the attributes that GTK maintains
for every widget.

a11y: Add some parser tests

Checking basic support for acessible states, properties
and relations in ui files.

Remove erroneous preconditions

Tests found these functions to be non-working.

a11y: Reuse builder parsing for enums

No need to manually write all these parsing functions
when _gtk_builder_enum_from_string does exactly what
is needed here.

a11y: Parse booleans in ui files as expected

Accept the same syntax for booleans as GtkBuilder
does elsewhere.

builder: Expot _gtk_builder_boolean_from_string privately

When specifying accessible properties in ui files, it
is better to accept the same syntax for booleans as
elsewhere, so lets reuse this function.

Update Polish translation

scale: Set round-digits to -1 initially

This ensures that keybindings for small-step changes
work despite draw-value being FALSE now. This was
fallout from 8ca612c9664bf6f8ae7fe that showed up
as arrow keys not working anymore for the color scales
in the color chooser.

Cosmetics

Remove some comments that refer to no longer
existing menu code.

color editor: Add accessible labels

Add some labels to the controls in this dialog.

a11y: More State<>Change confusion

We should really avoid this needless duplication
- the 'state' is never stored anywhere.

a11y: Handle all cases for state change

Make state_change handle state changes for non-widgets,
and handle the cases for HIDDEN involving stack pages.

stack: Update HIDDEN a11y state for stack pages

This will let us handle additions and removals
in the AT-SPI backend.

Cosmetics

Make gtk_at_spi_root_child_changed take a
GtkAccessible for the child.

Merge branch 'meson-deps-continued' into 'master'

Turn more options into "feature"

See merge request GNOME/gtk!2708

stack: Don't transition when the visible child is remove

This is a corner-case, and it is causing crashes in
the shortcuts window, after a11ab6c995a38fde0eba.

a11y: Redo child-added/-removed for toplevels

Instead of monitoring the list of toplevels, rely
on GtkWindow updating the HIDDEN state before windows
get removed. This is better, since we still have the
object available when it happens, so we can pass it
to the ATs.

window: Maintain accessible HIDDEN state

We want to use the HIDDEN state to control when
things get added and removed from the accessible
tree, so ensure that we a) set HIDDEN to true
initially for windows, and b) we update HIDDEN
when a window is shown or hidden.

The second part is handled by gtk_widget_hide
for other widgets, but hiding a window does not
always go through that code path.

a11y: Emit child notification when toplevels get hidden

When a toplevel window gets hidden (and not destroyed),
the frontend code set the HIDDEN state, and we need to
emit child notification when that happens.

a11y: Improve child index helpers

We need to use gtk_accessible_should_present() whenever we
calculate accessible tree positions, to avoid inconsistencies.

While we are at it, make these helpers usable for finding
the position of accesibles that are now ignored, by not
looking at should_present for the object itself. This will
be relevant when we calculate the position of objects whose
HIDDEN state changes.